Skip to content

feat(metadata): support advanced generics using recursion#763

Open
moshams272 wants to merge 7 commits intonodejs:mainfrom
moshams272:feat/advanced-generics
Open

feat(metadata): support advanced generics using recursion#763
moshams272 wants to merge 7 commits intonodejs:mainfrom
moshams272:feat/advanced-generics

Conversation

@moshams272
Copy link
Copy Markdown
Contributor

Description

This PR uses the Recursive approach instead of using Regex that just covered the basic generic and can't handle:

  • Nested Generics Transformer<T, Awaitable<U>>
  • Function Signature (str: MyType) => Promise<T>
  • Complex Union and Intersection string & number | boolean
  • Depth

The new implementation uses a top-down Recursive approach, breaking down types layer by layer starting from the weakest operators to the strongest.

Validation

  • Added comprehensive test cases in transformers.test.mjs
  • Run node --run test and verified that all test cases (old and new) passed successfully.

Related Issues

This PR acts as an extension to #666. While #666 solved the basic mapping, this implementation introduces a recursive parser to handle more complex nested types.

Check List

  • I have read the Contributing Guidelines and made commit messages that follow the guideline.
  • I have run node --run test and all tests passed.
  • I have check code formatting with node --run format & node --run lint.
  • I've covered new added functionality with unit tests if necessary.

@moshams272 moshams272 requested a review from a team as a code owner April 12, 2026 08:46
@vercel
Copy link
Copy Markdown

vercel bot commented Apr 12, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
api-docs-tooling Ready Ready Preview Apr 14, 2026 8:02am

Request Review

@cursor
Copy link
Copy Markdown

cursor bot commented Apr 12, 2026

PR Summary

Medium Risk
Replaces the type-linking parser with a new recursive implementation, which can change how complex type strings are rendered across generated docs. Risk is mitigated by added unit coverage but could still surface edge-case formatting differences.

Overview
Updates transformTypeToReferenceLink to use a new recursive parseType implementation instead of the prior regex/split-based generic handling.

The new parser adds support for nested generics, function return types (=>), and correct union/intersection splitting with parentheses depth handling and operator precedence. Tests are expanded to cover function+generic types and deeply nested combinations, and the old TYPE_GENERIC_REGEX constant is removed.

Reviewed by Cursor Bugbot for commit e746538. Bugbot is set up for automated code reviews on this repo. Configure here.

@codecov
Copy link
Copy Markdown

codecov bot commented Apr 12, 2026

Codecov Report

❌ Patch coverage is 82.14286% with 35 lines in your changes missing coverage. Please review.
✅ Project coverage is 78.32%. Comparing base (3d00fa8) to head (e746538).

Files with missing lines Patch % Lines
src/generators/metadata/utils/typeParser.mjs 79.41% 30 Missing and 5 partials ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##             main     #763      +/-   ##
==========================================
- Coverage   78.43%   78.32%   -0.12%     
==========================================
  Files         157      158       +1     
  Lines       13962    14047      +85     
  Branches     1152     1169      +17     
==========================================
+ Hits        10951    11002      +51     
- Misses       3006     3035      +29     
- Partials        5       10       +5     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

- Enforce exact TS operator precedence: Arrow functions (=>) before Unions (|) and Intersections (&).

- Implement stripOuterParentheses to unwrap redundant outer groups and prevent parser depth-blindness.

- Fix array loss: safely preserve [] notation for both base types and generics.

- Correctly handle higher-order functions by re-joining subsequent arrow operator segments.
Copy link
Copy Markdown

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 2 potential issues.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit d343adb. Configure here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants